home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 26 / AACD 26.iso / AACD / Online / Qpopper / popper.0 < prev    next >
Encoding:
Text File  |  1996-02-01  |  9.5 KB  |  265 lines
  1.  
  2.  
  3.  
  4. popper(8)            Maintenance Procedures             popper(8)
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      popper - pop 3 server
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////uuuussssrrrr////eeeettttcccc////ppppooooppppppppeeeerrrr [ -d ] [ -s ] [ -t trace-file] [ -T timeout]
  13.      [ -b bulldir]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _P_o_p_p_e_r is an implementation  of  the  Post  Office  Protocol
  17.      server  that  runs  on a variety of Unix computers to manage
  18.      electronic mail for Macintosh  and  MS-DOS  computers.   The
  19.      server  was  developed  at  the  University of California at
  20.      Berkeley and conforms fully to  the  specifications  in  RFC
  21.      1081 and RFC 1082.
  22.  
  23.      The ----dddd flag sets the socket to debugging and turns on debug-
  24.      ging.   All  debugging information is saved using syslog(8).
  25.      The ----tttt ttttrrrraaaacccceeee----ffffiiiilllleeee flag turns  on  debugging  and  saves  the
  26.      trace information in _t_r_a_c_e-_f_i_l_e using fprintf(3V).
  27.  
  28.      The ----ssss flag turns on statistics logging using syslog(8).  At
  29.      the end of each popper session, the following information is
  30.      logged: username, number  of  messages  deleted,  number  of
  31.      bytes  deleted,  number of message left on server, number of
  32.      bytes left on server.
  33.  
  34.      The ----TTTT ttttiiiimmmmeeeeoooouuuutttt option changes  the  default  compiled  value
  35.      POP_TIMEOUT  for  terminating  a  session with a pop client.
  36.      When the server is waiting for a command to arrive from  the
  37.      client,  it  times out after the specified number of seconds
  38.      and terminates  the  session.   This  avoids  having  popper
  39.      processes  hang  forever  waiting  for  command  input  from
  40.      clients which have terminated abnormally.  A small value  is
  41.      ok  for  small  to  medium  nets  where the network delay is
  42.      within a few seconds.  In this case  15-30  seconds  is  not
  43.      unreasonable.  Networks with large delays in sending packets
  44.      (e.g., SLIP links) may require a larger value.  In this case
  45.      300 seconds (5 minutes) is not unreasonable.
  46.  
  47.      The ----bbbb bbbbuuuullllllllddddiiiirrrr option turns  on  the  bulletin  feature  and
  48.      specifies the bulletin directory path.
  49.  
  50. BBBBUUUULLLLLLLLEEEETTTTIIIINNNNSSSS
  51.      The bulletin feature gives system administrators  a  way  to
  52.      send important announcements to all POP users without having
  53.      to do mass mailings.
  54.  
  55.      The bulletin directory contains one file per bulletin.  Each
  56.      file  contains a single mail message with header and body in
  57.      mailbox format. The first line of each such bulletin must be
  58.      a "From " line. The easiest way for sysadmins to create such
  59.      bulletins is to mail themselves a copy of the bulletin using
  60.  
  61.  
  62.  
  63. Sun Microsystems    Last change: August 1990                    1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. popper(8)            Maintenance Procedures             popper(8)
  71.  
  72.  
  73.  
  74.      the  account to which they want replies to be sent, then use
  75.      their mail program to save the message to a file in the bul-
  76.      letin  directory  in  mailbox format. The bulletin directory
  77.      must be world readable.
  78.  
  79.      The name of each bulletin  file  begins  with  the  bulletin
  80.      number,  and  may optionally continue with any other charac-
  81.      ters. E.g., the file name of bulletin  number  23  might  be
  82.      "23.pophost_down_sunday".
  83.  
  84.      Popper creates a file named .popbull in the  home  directory
  85.      of each user. This file contains a single line recording the
  86.      highest numbered bulletin received by the user.
  87.  
  88.      Each time a POP client connects to the server, any new  bul-
  89.      letins  which  the  user  has  not  received  previously are
  90.      automatically appended to the user's mail.
  91.  
  92.      When a bulletin is copied, the "To" header line is  replaced
  93.      by  "To:  username@thishost", and any "Status:" header lines
  94.      are deleted. Otherwise, the bulletin is copied as is.
  95.  
  96.      When a new user checks  for  mail  the  first  time,  popper
  97.      creates  the  .popbull file in the user's home directory and
  98.      seeds it with the current maximum bulletin number. Thus  new
  99.      users do not get old bulletins.
  100.  
  101. TTTTHHHHEEEE PPPPOOOOPPPP TTTTRRRRAAAANNNNSSSSAAAACCCCTTTTIIIIOOOONNNN CCCCYYYYCCCCLLLLEEEE
  102.      The Berkeley POP server is a single program (called  popper)
  103.      that  is launched by inetd when it gets a service request on
  104.      the POP TCP port.  (The official port  number  specified  in
  105.      RFC  1081 for POP version 3 is port 110.  However, some POP3
  106.      clients attempt to contact the server at port 109,  the  POP
  107.      version  2  port.  Unless you are running both POP2 and POP3
  108.      servers, you can simply define both ports  for  use  by  the
  109.      POP3 server.  This is explained in the installation instruc-
  110.      tions later on.)  The popper program initializes  and  veri-
  111.      fies  that  the  peer  IP address is registered in the local
  112.      domain, logging a warning message when a connection is  made
  113.      to a client whose IP address does not have a canonical name.
  114.      For systems using BSD 4.3 bind, it also checks to see  if  a
  115.      cannonical  name lookup for the client returns the same peer
  116.      IP address, logging a warning message if it does  not.   The
  117.      the  server enters the authorization state, during which the
  118.      client must correctly identify itself by providing  a  valid
  119.      Unix  userid  and password on the server's host machine.  No
  120.      other exchanges are allowed during this state (other than  a
  121.      request  to  quit.)  If authentication fails, a warning mes-
  122.      sage is logged and the session ends.  Once the user is iden-
  123.      tified,  popper changes its user and group ids to match that
  124.      of the user and enters the transaction  state.   The  server
  125.      makes  a temporary copy of the user's maildrop which is used
  126.  
  127.  
  128.  
  129. Sun Microsystems    Last change: August 1990                    2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. popper(8)            Maintenance Procedures             popper(8)
  137.  
  138.  
  139.  
  140.      for all subsequent transactions.  These include the bulk  of
  141.      POP  commands  to retrieve mail, delete mail, undelete mail,
  142.      and so forth.  When the client quits, the server enters  the
  143.      final  update  state  during which the network connection is
  144.      terminated and the user's maildrop is updated with the (pos-
  145.      sibly) modified temporary maildrop.
  146.  
  147. LLLLOOOOGGGGGGGGIIIINNNNGGGG
  148.      The POP server uses syslog to keep a record of  its  activi-
  149.      ties.   On  systems with BSD 4.3 syslogging, the server logs
  150.      (by default) to the "local0" facility at  priority  "notice"
  151.      for  all messages except debugging which is logged at prior-
  152.      ity    "debug".      The     default     log     file     is
  153.      /usr/spool/mqueue/POPlog.  These can be changed, if desired.
  154.      On systems with 4.2 syslogging all messages  are  logged  to
  155.      the local log file, usually /usr/spool/mqueue/syslog.
  156.  
  157. DDDDEEEEBBBBUUUUGGGGGGGGIIIINNNNGGGG
  158.      The popper program will log debugging information  when  the
  159.      -d  parameter  is  specified  after  its  invocation  in the
  160.      inetd.conf file.  Care should be  exercised  in  using  this
  161.      option  since it generates considerable output in the syslog
  162.      file.  Alternatively, the "-t <file-name>" option will place
  163.      debugging  information into file "<file-name>" using fprintf
  164.      instead of syslog.
  165.  
  166.      For SunOS version 3.5, the popper  program  is  launched  by
  167.      inetd  from  /etc/servers.   This file does not allow you to
  168.      specify command line arguments.  Therefore, if you  want  to
  169.      enable   debugging,  you  can  specify  a  shell  script  in
  170.      /etc/servers to be launched instead of popper  and  in  this
  171.      script call popper with the desired arguments.
  172.  
  173.      You can confirm that the POP server is running  on  Unix  by
  174.      telneting  to  port  110 (or 109 if you set it up that way).
  175.      For example:
  176.  
  177.      %telnet myhost 110
  178.      Trying...
  179.      Connected to myhost.berkeley.edu.
  180.      Escape character is '^]'.
  181.      +OK UCB Pop server (version 1.6) at myhost starting.
  182.      quit
  183.      Connection closed by foreign host.
  184.  
  185. EEEEXXXXTTTTEEEENNNNSSSSIIIIOOOONNNNSSSS
  186.      The server implements two extended commands.
  187.  
  188.      XTND XMIT: Sends a mail message using /usr/lib/sendmail.
  189.  
  190.      XTND XLIST header [num]: Extracts and returns the  specified
  191.      header  line  for the specified message number. If the "num"
  192.  
  193.  
  194.  
  195. Sun Microsystems    Last change: August 1990                    3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. popper(8)            Maintenance Procedures             popper(8)
  203.  
  204.  
  205.  
  206.      parameter is missing, returns the header line  for  all  the
  207.      messages which are not currently marked for deletion.
  208.  
  209. FFFFIIIILLLLEEEESSSS
  210.      /usr/spool/mail         mail files
  211.      /etc/inetd.conf         pop program invocation
  212.      /etc/syslog.conf        logging specifications
  213.      ~/.popbull              largest bulletin number seen by user
  214.  
  215. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  216.      inetd(8), RFC1081, RFC1082
  217.  
  218. AAAAUUUUTTTTHHHHOOOORRRRSSSS
  219.      Bob Campbell, Edward Moy, Austin Shelton, Marshall  T  Rose,
  220.      and cast of thousands at Rand, UDel, UCI, and elsewhere
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261. Sun Microsystems    Last change: August 1990                    4
  262.  
  263.  
  264.  
  265.